NAME¶

authselect-migration - Un guide sur la façon de migrer de authconfig vers authselect.

DESCRIPTION¶

Cette page de manuel explique les principales différences entre authconfig, l’outil précédant pour configurer les sources d’authentification et d’identité du système, et authselect qui le remplace. Elle explique également quelles actions doivent être faites afin de migrer de authconfig vers authselect.

DIFFÉRENCES PRINCIPALES¶

Authselet a une approche totalement différente de la configuration système que authconfig, l’outil précédent.

Authconfig fait de son mieux pour garder les changements manuels des utilisateurs dans les fichiers qu’il génère. Il génère non seulement les fichiers de configuration PAM et nsswitch.conf (pour la configuration des modules sources d’authentification et d’identité) mais il génère également des fichiers de configuration simple pour plusieurs services tels que LDAP et Kerberos.

Authselect ne fait pas ceci. Il n’essaye pas de générer de fichiers de configuration autre que PAM et nsswitch.conf et il interdit strictement tout changement manuel à la configuration générée. Il offre un ensemble de fichiers appelés profils. Chaque profil décrit ce à quoi la configuration résultante doit ressembler et elle peut être légèrement modifiée en activant ou désactivant quelques fonctionnalités optionnelles. Si un besoin se manifeste pour un profil différent de ceux fournis avec authselect, l’administrateur a une option pour créer un tout nouveau profil et l’utiliser avec authselect. Lisez authselect-profiles(5) pour en savoir plus sur les profils.

Cela pourrait être un grand désavantage, mais c’est en fait le contraire. Authconfig est un très vieux outil et les applications offrants les services requis ont changé rapidement à travers les années. Typiquement, il n’y a plus besoin d’avoir de multiples modules d’authentification dans PAM et nsswitch.conf, car la grande majorité des cas d’usages sont couverts par SSSD. En conséquence, il n’y a plus particulièrement besoin de les ajouter ou supprimer. Il y a également de meilleurs outils pour générer la configuration pour les démons système, qui peuvent vous aider à automatiser le process pour rejoindre un domaine distant tel que « realm ». De plus, les profils embarqués nous donnent une vision de la configuration système compréhensible et déterministe qui peut être complètement testée et moins sujette à l’erreur. Il est également beaucoup plus facile de distribuer ce type de configuration à travers de nombreux systèmes.

Le changement qui est probablement le plus controversé est que seul authselect fourni des profils pour les fournisseurs sssd et winbind. Ces deux fournisseurs couvrent tous les cas d’utilisation modernes de la fourniture d’utilisateurs locaux et au domaine LDAP legacy aux configurations complexes avec des serveurs IPA ou Active Directory. Les profils ne contiennent plus la prise en charge de nss-pam-ldapd et les utilisateurs sont encouragés à basculer vers sssd.

JOINDRE DES DOMAINES DISTANTS¶

Vous pouvez utiliser ipa-client-install ou realm pour joindre un domaine IPA et realm pour joindre un domaine Active Directory. Ces outil s’assureront que le bon profil authselect est sélectionné et que tous les démons et services sont correctement configurés.

CONVERTIR VOS SCRIPTS¶

Vous pouvez utiliser ipa-client-install ou realm pour joindre un domaine, vous pouvez simplement retirer tout appel à authconfig dans vos scripts. Si ce n’est pas envisageable, vous devez remplacer chaque appel authconfig avec son équivalent d’appel authselect pour sélectionner un profil correct avec les fonctionnalités désirées. Alors, vous devrez également écrire le fichier de configuration pour les services requis.

Table 1. Relations entre les options authconfig et les profils authselect

Table 2. Relations entre les options authconfig et les fonctionnalités de profil authselect

Exemples.

authconfig --enableldap --enableldapauth --enablefaillock --updateall
authselect select sssd with-faillock
authconfig --enablesssd --enablesssdauth --enablesmartcard --smartcardmodule=sssd --updateall
authselect select sssd with-smartcard
authconfig --enablepamaccess --updateall
authselect select sssd with-pamaccess
authconfig --enablewinbind --enablewinbindauth --winbindjoin=Administrator --updateall
realm join -U Administrator --client-software=winbind WINBINDDOMAIN

FICHIERS DE CONFIGURATION¶

Ce paragraphe contient des snippets pour une configuration minimal de divers services.

# Définir la base par défaut dn
BASE   dc=example,dc=com
# Définir le serveur LDAP par défaut
URI    ldap://ldap.example.com ldap://ldap-master.example.com:666

[libdefaults]


 default_realm = MYREALM
[realms]


 MYREALM = {


  kdc = kdc.myrealm.org


 }
[domain_realm]


 myrealm.org = MYREALM


 .myrealm.org = MYREALM

[sssd]
config_file_version = 2
domains = default
[domain/default]
id_provider = ldap
ldap_uri = _srv_
dns_discovery_domain = myrealm

[sssd]
config_file_version = 2
domains = default
[domain/default]
id_provider = ldap
auth_provider = krb5
ldap_uri = _srv_
krb5_server = _srv_
krb5_realm = MYREALM
dns_discovery_domain = myrealm

domain mydomain broadcast
# ou
# domain mydomain server myserver

NISDOMAIN=mydomain

$ domainname mydomain
$ setsebool -P allow_ypbind 1

DÉMARRAGE DES SERVICES¶

Selon votre configuration, vous avez besoin de démarrer les services nécessaires manuellement avec systemd.

systemctl enable sssd.service ; systemctl start sssd.service

systemctl enable winbind.service ; systemctl start winbind.service

systemctl enable rpcbind.service ; systemctl start rpcbind.service
systemctl enable ypbind.service ; systemctl start ypbind.service

systemctl enable oddjobd.service ; systemctl start oddjobd.service

OUTILS AUTHCONFIG¶

Authconfig est fourni avec un outil appelé cacertdir_rehash. Si vous dépendez de cet outil, veuillez basculer vers la commande native openssl : openssl rehash <dossier> qui sert le même but.

VOIR AUSSI¶

authselect(8), authselect-profiles(5), realm(8), ipa-client-install(1), sssd.conf(5), smb.conf(5), ldap.conf(5), krb5.conf(5)